Summary

Inserts a simple menu. The menu is generated as a TABLE with one row and one cell containing a list of links to the document that forms the menu. There also is an option to generate a list within a DIV element that more closely follows the Html standard that specifies that tables only should be used for real tabular data.

Component properties
Category AS Menu
Version 1.0
Complies with Xhtml 1.0 / 1.1 rules Yes
Supported server programming languages C# Visual Basic.NET
Output content type block

When to use

This component is typically used when there is a need for a very special and simple menu. However, generally this component is not particulary useful.

When placed on a page and rendered using the new style, the component will display a menu that look something like this:

Start Category 1 Item 1.1 Item 1.2 Category 2 Category 3 Item 3.1 Item 3.2 Category 4 Item 4.1 Category 5 Item 5.1 Item 5.2

The code rendered looks like this: 

 <div>
   <a href="default.aspx?di=23596"><b>Start</b></a>  
   <b>Category 1</b>
   <a href="default.aspx?di=37797">Item 1.1</a>  
   <a href="default.aspx?di=23570">Item 1.2</a>  
   <b>Category 2</b>
   <b>Category 3</b>
   <a href="default.aspx?di=23578">Item 3.1</a>  
   <a href="default.aspx?di=23576">Item 3.2</a>  
   <b>Category 4</b>
   <a href="default.aspx?di=23582">Item 4.1</a>  
   <b>Category 5</b>
   <a href="default.aspx?di=1271">Item 5.1</a>  
   <a href="default.aspx?di=23590">Item 5.2</a>  
 </div>

Programming interface

Parameters

General settings
Menu root document
The id of a document that is the root of the document hierarcy that should form the menu.
Presentation template
Optional presentation template id for all links generated
Use clickable roots
Indicates that the menu roots should be clickable.
Compatibility options
Use new output syntax
Indicates that the generated code should use a DIV element rather than the old TABLE element used in Content Studio v. 4. The new syntax is rendered equally as the old one in most browsers but complies with the accessibility standards.
Formatting options
Class name
A CSS class name to use when formatting the menu. This class is inserted on the TD element in the old output syntax and on the DIV element when the new syntax is in use.
Table formatting options (ignored when the new output syntax is used)
Table width
Sets value that indicates the width attribute of the generated table ex. 100%
Table cell spacing
Sets value that indicates the cellspacing to use with the generated table.
Table cellpadding
Sets value that indicates the cellpadding to use with the generated table
Table summary
Sets the summary attribute of the generated table. The default value is an empty string which omits the attribute. Omitting this attribute can cause xhtml 1.0 strict or higher validators to generate a warning.
Table caption
Sets the caption element connected to the the generated table. The default value is an empty string which omits the element. Omitting this element can cause xhtml 1.0 strict or higher validators to generate a warning.
Table border
Sets a value that indicates the border of the generated table. The default value is zero.

Remarks

You should avoid this component, it exists mainly for backward compatibility reasons, instead use the Insert menu 3.0 component that is based on modern technique and that is better for accessibility reasons as well.

General remarks with menu components

All menu driven components uses the Content Studio menu API:s and hierarchy document structures. The caller must have BROWSE permission to all items displayed and every item must be live and published. When the menu renders Content Studio traverses through the entire document tree and whenever there is a document that is not available to the caller the travers operation breaks at this point. This have the effect that any object that is a child of a unavailable document will be left out since the tree is broken at that point.